This online help page is dedicated to the SurgeONE.ai Business Details and Enroll Users stages and their associated functionalities. These are the three stages of getting started with your Firm or Organization in SurgeONE.ai.
1. Getting Started
Let us assume that you have already set your SurgeONE.ai login password and have successfully logged in for the first time.
After you login into SurgeONE.ai for the first time, you will need to specify details about your organization or firm to get started. There are three stages of setting up your organization related details in SurgeONE.ai.
- First, you must provide requisite information related to your business.
- In the next stage, you may allocate users who can access this created organization in SurgeONE.ai. You can skip this stage if you want to set up users or employees later on.
- In the final stage, you can view some available data integration options. Proceed to get redirected to the SurgeONE.ai dashboard view.
NOTE: The SurgeONE.ai Portal Admin user, as well as the Partner Contact user, can perform onboarding via the masquerade facility present in the admin portal after creating a company.
2. Providing Business Details
Here is the view of the Business Details page. The details you provide can be edited later on.
- By default, a placeholder text is present in the Firm Name field. You can edit or remove it to enter the name of your organization.
- Enter the current address of your organization in the Firm Address field.
- Select the applicable type of firm in the Firm Type dropdown.
- Select the country in the Country dropdown. Currently, only the USA option is available.
- Select the applicable state from the State dropdown options. The options are dependant on the country.
- Select the name of the city the firm is located at in the City dropdown. The options are dependant on the state.
- Enter the valid and unique zip code of your location in the ZIP field. It must be a 5-digit numeric value.
- Select the currency in the Currency dropdown. Currently, only the USD option is available.
- Enter the unique identifier assigned to financial professionals registered with the Financial Industry Regulatory Authority (FINRA) in the CRD Number field. It stands for Central Registration Depository number and is used to track the employment, licensing, and disciplinary history of brokers and investment advisers.
- You can also upload the firm logo using the Upload Logo button. The uploaded logo gets displayed at the top left of the SurgeONE.ai UI after onboarding is done.
- Click on the Next button at the bottom right to proceed to the following Enroll Users stage.
Fig: 1 - Fields of Business Details stage
NOTE: The above figure displays the placeholder text as RD AgroTech. This placeholder string value is fetched from the data that was initially provided as the name of the company at the time of this company creation, by the SurgeONE.ai portal administrator account.
Fig: 2 - Providing the address of the Firm or Organization
Fig: 3 - Selecting applicable Firm or Organization type
Fig: 4 - Selecting the Country of operation
Fig: 5 - Selecting applicable State
Fig: 6 - Selecting applicable City
Fig: 7 - Selecting applicable Currency
Fig: 8 - Entering applicable CRD number value
Fig: 9 - Button to upload firm logo
Fig: 10 - Next button to proceed
NOTE:
- All the fields, except for the CRD Number and Upload Logo fields, are mandatory while providing up your business details. The following screenshots displays the various field validations that are employed.
-
At the left side of the screen, you can notice the current stage you are in. The greyed out stage labels are yet to be accessed or not yet finalized. You can view a tick
icon against the section label once it is completed.
Fig: 11 - Fields validations
Fig: 12 - Different stages of getting started
3. Enrolling Users
Here is the view of the Enroll Users page. By default, the account that was created by the admin user is always listed out here as a row entry of the grid view.
You can proceed to add employee(s), or you can skip this activity for later set up. If you create an employee, the new employee details get listed in the grid view. The Enroll Users page displays the created users of the organization.
Fig: 13 - Enroll Users stage view
There is a row context menu that can be toggled using the vertical ellipsis
icon displayed under the ACTION column. The row context menu options Edit, Delete, Invite, Devices & Apps and Assign Role(s) are present. However, for the primary user, that is the Company / Branch Admin Role, the row-context menu options are greyed out, except for the last one.
Fig: 14 - Row context menu options greyed out
3.1. Creating New User / Employee
Click on the + Add Employee button to load the Create New Employee dialog box.
Fig: 15 - Create New Employee dialog box
The following fields are present:
- First Name: Enter the first name of the employee.
- Middle Name: Enter the middle name of the employee. This is an optional field.
- Last Name: Enter the last name of the employee.
- Email ID: Enter the valid email address of the employee. The invitation email will be sent at this address.
- City: Select the current city of the employee.
- ZIP Code: Enter the valid zip code of the employee address.
- Supervisor: You can select the current supervisor or manager of the employee. This is an optional field.
- Reference ID: You may enter the applicable reference identifier of the employee.
Proceed to perform the following steps to create a new employee:
- Enter the name of the employee in the First Name, Middle Name and Last Name fields, as applicable.
- Enter a valid email address in the Email ID field.
- Select the city in the City dropdown.
- Enter a valid 5-digit zip code in the ZIP Code field.
- You can select the current supervisor or manager of this new employee using the Supervisor dropdown. The employee can also be set as own supervisor using the Self dropdown option.
- You can enter appropriate value in the Reference ID field.
- Click on the Assign Role(s) button.
-
The system-defined roles are displayed on the left panel section. Select the applicable role of this new employee out of the designated options provided.
- Click on the checkbox of the left panel and then on the button with right arrow icon (>) to assign it. Multiple checkbox selection is permitted. Alternatively, you can also double click on the label to move it, instead of clicking on the right arrow icon. If you have performed a search operation and then click on this button, then only the filtered users will be moved, while the other users who were not fetched by the search operation, will not be moved.
- To assign all system roles at one go, click on the button with the (>>) icon.
- To remove any assigned role, click on the checkbox of the right panel and then on the button with left arrow icon (<). Multiple checkbox selection is permitted. Alternatively, you can also double click on the label to move it, instead of clicking on the left arrow icon. If you have performed a search operation and then click on this button, then only the filtered users will be moved, while the other users who were not fetched by the search operation, will not be moved.
- To unassign all the assigned system roles at one go, click on the button with the (<<) icon.
- Click on the Done button to confirm the role assignment.
- Now that the employee details are provided and the role(s) is assigned, click on either one of the Save or the Save & Send Activation Link button to save this new employee, as explained below:
-
If you click on the Save button, then the user gets created and needs to be invited for the invitation email to get triggered from the system. The invited user can set password and login to SurgeONE.ai. The new user details get listed in the grid view and can be invited later on. After the user is created, a success notification can be seen.
Here is the view of the user account which is created using the Save button. The row context menu (toggled using the vertical ellipsis icon) displays selectable Edit, Delete, Invite and Devices & Apps options. - If you click on the Save & Send Activation Link button, then the user gets created and the invitation email is triggered from the system. When adding employee during onboarding process and pressing on the Save & Send Activation Link button, the email gets triggered after all the three steps of the onboarding process is completed. The new user details also get listed in the grid view. After the mail is triggered a success notification can be seen.
Fig: 16 - City dropdown
Fig: 17 - Supervisor dropdown
Here is the view of the new employee details populated in the respective fields.
Fig: 18 - New Employee details populated
Fig: 19 - Assign Role(s) button
Here is a view of the various roles that are listed.
Fig: 20 - View of the System Roles on the left panel
Fig: 21 - Setting System Roles
Fig: 22 - Save buttons
Fig: 23 - Row context menu options of the created employee
Whereas, for the Company / Branch Admin role (primary user), only the last menu option is enabled, while the rest are disabled. Refer to the following screenshot:
Fig: 24 - Row context menu options of the Company / Branch Admin role
Fig: 25 - Success notification of invite mail trigger
NOTE:
- The following screenshot shows the various field validations that are implemented for creating the new employee.
- You must assign at least one role to the new employee before saving. Otherwise, the system will prompt you to do so.
- You must have at least one role added in the right panel labeled as Assigned Roles to be able to save the assigned role(s). Otherwise, the system will prompt you to do so when you click on the Done button before assigning any role to the new employee.
Fig: 26 - Field validations
Fig: 27 - Role needs to be assigned to save employee
Fig: 28 - Role needs to be selected and moved to the Assigned Roles panel area
3.2. Editing User / Employee
You can edit a created employee. Click on the row context Edit menu after clicking on the vertical ellipsis
icon displayed under the ACTION column.
Fig: 29 - Edit option of the row context menu
Here is the view of the Edit Employee dialog box.
Fig: 30 - Edit Employee dialog box
The existing employee details are populated and can be edited, except for the Email ID field, which is a read-only field.
Fig: 31 - Email ID field cannot be edited
If you click on the Save button, then the user details get stored. If you click on the Save & Send Activation Link button, then user details get stored, and the invitation email is triggered from the system. After the mail is triggered a success notification can be seen.
Fig: 32 - Success notification
3.3. Deleting User / Employee
Perform the following steps to delete a created user while setting up your firm.
- Click on the row context Delete menu after clicking on the vertical ellipsis
icon displayed under the ACTION column. - After you click on it, the system will prompt a confirmation dialog box. Click on the Yes button to proceed to remove the user account.
Fig: 33 - Delete option enabled and clicked on to load the confirmation prompt
NOTE:
- Once the user account is deleted, the account cannot be restored, and the user cannot login to the application.
- You cannot delete the primary user account (logged-in user) by using this context menu option. You can click on the row context vertical ellipsis
icon and notice that the expanded Delete menu option is greyed out for the logged-in user account who is set for the Company / Branch Admin Role.
Fig: 34 - Delete option of the row context menu disabled for Company / Branch Admin
3.4. Inviting User / Employee
- You can click on the row context vertical ellipsis
icon and click on the expanded Invite menu option to invite the account of any existing user of your organization (who is yet to be invited). - The Send Invitation to User modal window loads.
- The status updates to Invited. The following success notification is displayed.
Fig: 35 - Invite option for Inviting user
Fig: 36 - Send Invitation to User modal window view
The following image displays the various dropdown options of the Select Template field. Select any one applicable option and click on the Send Invite button.
Fig: 37 - Choosing method of Inviting user
Fig: 38 - Invite mail success notification
NOTE: The invitation email is sent to the stored email address. The invited user / employee can set your SurgeONE.ai account password from the embedded link of the invitation email.
3.5. Viewing Devices / Apps Details
You can click on the row context vertical ellipsis
icon and click on the expanded Devices & Apps menu option to view the devices and apps info. The Device details modal window loads to display the devices and apps specific information related to the associated user.
Here is the view when no details are present.
Fig: 39 - Devices & Apps option of the row context menu loads the Device details view showing no details
Here is the view when devices / apps details are present.
Fig: 40 - Device details view populated with details
Click on the Submit button to finalize the organization.
Fig: 41 - Submit button
Get navigated to the SurgeONE.ai Dashboard. Your Firm / Organization setup is now complete.
Fig: 42 - SurgeONE.ai Dashboard view